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Use of DANGER, WARNING, CAUTION, and NOTE 


This publication includes, DANGER, WARNING, CAUTION, and NOTE information where appropriate to point out safety 
related or other important information. 


DANGER Hazards which could result in severe personal injury or death 
WARNING Hazards which could result in personal injury 

CAUTION Hazards which could result in equipment or property damage 
NOTE Alerts user to pertinent facts and conditions. 


Although DANGER and WARNING hazards are related to personal injury, and CAUTION hazards are associated with 
equipment or property damage, it should be understood that operation of damaged equipment could, under certain operational 
conditions, result in degraded process performance leading to personal injury or death. Therefore, comply fully with all 
DANGER, WARNING, and CAUTION notices. 
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consequential damages arising from use of any software or hardware described in this document. 
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Chapter 1 Introduction 


1.1 Before You Begin 


The purpose of this document is to give an overall description of the Advant Station 500 Series 
Operator Station, version 1.7 and 1.8, localization functionality. The intended audience is the 
software developers who are going to add a new language to the Advant Station 500 Series 
Operator Station. You have to have some knowledge of the Advant Station 500 Series Operator 
Station and the terminology used within the business area. You must decide who will be 
responsible for the work to be done and who will take the maintenance responsibility for the 
translated version. 


1.1.1 Responsibility distribution 


The basic software is developed and owned by ABB Industrial Systems AB (SEISY). 

The responsibility for maintenance and development of English, German, Swedish and Chinese 
languages lies within SEISY. 

The responsibility for developing of translated texts in the software and keyboard lies at the 
translating LIAD. The responsibility for maintenance and further development of texts and 
keyboard lies at the LIAD. 


New Release Revision 
Physical Contents 
media 
OO OO 
4) sw Rel. Sa | sw 
Eng. Eng. 
Version Notes Version 

X.y/0 X.y/1 
5 BUAPS BU-spec. — BU-spec. 
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® Lang.X Lang| 
— Lang. Lang. 
3 oO) — OUl-F |X 
S f SW Alt.1 SW 4 
ae Translate v 
= “iw | Revision) _Alt.2 

——— [OO 
ang. Compl. SW 
in lang. X 


Figure 1-1. Responsibility borderline for translation of texts in the 
Advant Station 500 Series Operator Station 
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1.1.2 What is available and not from SEISY for a translation 


From SEISY you can order a tape with the standard product software. The standard product 
supports the languages English, German, Swedish and Chinese. For how to make a translation 
there is a manual (this). The manual describes the procedure how to adapt the software and 
hardware to the local language. A localized operator keyboard can be ordered from SEISY. 
See Section 1.2.1, How to order an operator keyboard with the native language 


Some localized hardware can not be ordered from SEISY. This hardware has to be ordered from 
the local HP purchaser. HP keyboard, if not possible to use any of the above mentioned 
language, has to be purchased locally. If the printer require some local fonts, the printer has to 
be purchased locally. A lot of fonts are supported by HP in the HP-UX. To get to know what 
font sets that are supported you have to check in the product software. Business Unit (BU)- 
specific additions are not in the standard operator station software. These are normally added by 
a BU. If there are any questions about the BU-specific part, the BU has to be contacted. 


1.2 Equipment Requirements 


To make a translation of texts in Advant Station 500 Series Operator Station you need the 
software version 1.7 and 1.8. This version requires 64 Mbyte of primary memory to run 
properly. If the language requires special fonts that are not supported in the Advant Station 500 
Series Operator Station version 1.7 and 1.8, these fonts have to be requested from HP. To get 
localized operator keyboard, the job to produce it can be ordered from department SEISY. 

See Section 1.2.1, How to order an operator keyboard with the native language. 


1.2.1 How to order an operator keyboard with the native language 


1-2 


In the price list there is an article number for the keyboard, that shall be used for translation. 
A set of blank keytops for engraving, “of your own”, is also available in the price list. 


For production of a language specific keyboard (mechanical or membrane) the LIAD shall con- 
tact SEISY, who will quote or have a fixed price for the work. Alternatively SEISY take the cost 
themselves and become owner of the keyboard. Otherwise the orderer is the owner. There is a 
special form that can be requested from SEISY when a keyboard shall be specified. The form 
shall be filled in by the LIAD and sent to SEISY when ordering of a special language variant. 
SEISY will return an article number to the LIAD for ordering the keyboard from the SEISY pro- 
duction department. 


HP keyboard and printer for the local language has to be bought locally from HP. 
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1.3 How to Use This Book 


This book is organized into chapters and sections as shown in Figure 1-1. 
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1.4 Conventions 


Figure 1-2. Organization of this Manual 


The following conventions are used throughout this manual for the presentation of material: 
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The words in proper names of screen elements (for example, the title in the title bar of a 
window, the label for a field of a dialog box) are initially capitalized. 


The names of keyboard keys are boldfaced. 


— Initial capital letters are used for the name of a keyboard key if it is labeled on the 
keyboard. For example, the Return key or <Return>. 


— Lowercase letters are used for the name of a keyboard key that is not labeled on the 
keyboard. For example, the space bar, comma key, and so on. 


— In descriptions, the word “key” is used in conjunction with its name. For example, 
pressing the Return key initiates the process. 


— In tables and procedures, angle brackets replace the word “key.” For example, press 
<Return>. 


— A dash is used to indicate that you must simultaneously press several keys. 
For example, <Ctrl-C> indicates that you must hold down the Control key while 
pressing the C key. 
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— The phrase “press and release” is used to indicate that you sequentially press several 
keys. For example, to close a window, press and release <Alt>, and then <F4>. 
This indicates that you press and release the Alt key, and then you press and release 
the F4 function key. 


The names of push and toggle buttons are boldfaced. 


— Initial capital letters are used for the name of a push or toggle button labeled on the 
display. For example, the OK button. 


—  Indescriptions, tables and procedures, the word “button” is used in conjunction with 
its name. For example, pressing the OK button initiates the process. 


The names of menus and menu items are boldfaced. 


— Initial capital letters are used for the name of menus listed in the menu bar. 
For example, the File menu. 


— Initial capital letters are used for the name of menu items. For example, to open a new 
window, choose New from the File menu. 


System prompts/messages are shown in the Courier font, and user responses/input are in 
the boldfaced Courier font. For example, if you enter a value out of range, the following 
message is displayed: 


Entered value is not valid. The value must be 0-30. 


In a tutorial, you may be told to enter the string TIC132 in a field. The string is shown as 
follows in the procedure: 


TIC132 
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1.5 Related Documentation 


Table 1-1 lists all documentation related to the Advant Station 500 Series Operator Station 
version 1.7 and 1.8. 


Table 1-1. Related Documentation 


Category Title Description 
Hardware | Advant Station 520/B132L Hardware This book provides instructions for hardware 
Reference Manual setup and installation of the Advant Station 
520/B132L 
Advant Station 520i/B132 Hardware This book provides instructions for hardware 
Reference Manual setup and installation of the Advant Station 
520/B132 


Software |AdvaCommand Basic Functions User’s Guide | This book give a detailed description of all 
basic functions in AdvaCommand, including 
User Interface, Event and Alarm, and System 


Status. 
AdvaCommand User Interface Reference This book give a detailed description of all 
Manual basic display elements and dialogs in 
AdvaCommand. 


Options | AdvaBuild On-line Builder Reference Manual | This book provides instructions for accessing, 
and using all On-line Builder functions. 


AdvaBuild On-line Builder Operator Station This book provides instructions for accessing, 
User’s Guide") and using all On-line Builder Operator Station 
functions. 


AdvaCommand Process Sectioning User’s This book provides instructions for accessing, 
Guide and using all Process Sectioning functions. 


AdvaCommand Status List User’s Guide This book provides instructions for accessing, 
and using all Status List functions. 


AdvaCommand X Workplace Server User’s _ | This book provides instructions for accessing, 
Guide and using all X Workplace Server functions. 


AdvaBuild Display Builder This book provides instructions for accessing, 
and using all Dsplay Builder functions. 


(1) Should be used together with the AdvaBuild On-line Builder Reference Manual 


1.6 Release History 


This is the first release of the AdvaCommand Localization software. 
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1.7 Terminology 


The following is a list of terms, that you should be familiar with, associated to the Advant OCS 
System with ABB Master software. Some terms and expressions used in this document are 
explained beneath: 


Term Description 
NLS Native Language Support 
Internationalization The design and modification of software so it can be adapted to 


various local customs and coded character sets. 


Localization The process of adapting an existing software product for use in a 
particular country or geographic region. 


1.8 Product Overview 


The product “Advant Station 500 Series Operator Stations with, or upgraded to version 1.7 or 
1.8”, are available for translation into other than above mentioned languages. 
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Chapter 2 Installation 


2.1 Installation Procedures 


The Operator Station is delivered with the AdvaCommand software already installed. 


For installation of the software for Advant Station 500 Series Operator Station version 1.7 and 
1.8, refer to the Release Notes that is delivered with the product versions. 


For a description of how to connect the DAT-drive to the Operator Station, see the appropriate 
hardware manual (Advant Station 520/B132L Hardware Reference Manual, or Advant Station 
520i/B132 Hardware Reference Manual) for information. 


2.2 Shut-down Procedures 


Refer to AdvaCommand Basic Functions User’s Guide for information. 


2.3 Start-up Procedures 


Refer to AdvaCommand Basic Functions User’s Guide for information. 
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Chapter 3 Configuration/Application Building 


3.1 Introduction 


Users of ABB Advant Open Control System OCS speak a variety of languages and observe 
many different cultural practices. Local-language, processing capability is becoming high 
priority with the kinds of software products in use throughout the world. For this reason, users 
need software which will easily accommodate local conventions. 


The two processes in the NLS approach that enhance software for international use are: 
internationalization and localization. 


° internationalizing software include: 


— supporting the letters and symbols required to read and write the user’s language, 
for example using standardized character sets that includes the most commonly used 
languages. 


— processing characters and text according to the rules of the user’s language, for 
example the collation order. Countries have different rules for sorting words. 
In Spanish, the sequence “ch” and “Il” are treated as single character and are sorted 
between “c” and “d’”, and between “I” and “m” respectively. 


— providing the schema to process translated messages and prompts, that is separate the 
application from the language-dependent information as text in menus, labels, 
prompts, help, and so on. 


— changing functions and conventions to comply with local requirements. For example 
representation of data and time format, number formatting and so on. 


° localizing adapts the software to a particular locale, including the translation of messages. 


3.1.1 NLS system in Advant Station 500 Operator Station 


The NLS system in AdvaCommand has a hierarchical structure in three levels. The levels are 
subsystem, components and messages. 


Each message has a unique identification, consisting of three integers representing Message 
number, Component number and Subsystem number. 


For each subsystem there is a component definition file. The file bsSubSystem.def specifies 
where to find this files. 


For each component there is one file containing all the messages for the component. 


$BSMESSAGE 
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bsSubSystem.def bsOS.def dcAl.cat 


Class_dcAl_bsOS 2 Class 


bsOS 7 $0S_STANDARD/nls/bsOS.def |__—_ a>} dcAl_bsOS 2 dcAi.cat + >| 


The identification for messages is: <Message>_<Component>_<Subsystem> 
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3.2 Adding a new language 


This section describe the preparations that has to be done to add a new language. Follow the 
sections in sequential order. 


3.2.1 New directories 


3-2 


Configuration data is stored in different directory structures depending on who the configurator 
is, that is who created the configuration data. This also include the NLS files. At delivery NLS 
files are stored in the directory structure, ‘standard’. The directory structures for ‘adaption’ and 
‘customer’ includes the same sub-directories as ‘standard’. Other ABB companies that adds 
texts to an Advant Station 500 Series Operator Station uses the directory structure ‘adaption’ for 
storage of its NLS files. Texts changed or added that affects only the current operator station are 
stored in the directory structure for ‘customer’. 


Directory Structure for message files in Advant Station 500 Operator Station: 
/products/data/standard/OS/nls/S$LANG/ 
/products/data/adaptions/OS/nls/S$LANG/ 
/products/data/customer/OS/nls/S$LANG/. 


NOTE 


$LANG is the value of the environment variable LANG. For american-english 
$LANG = en_US.iso88591. 


The directory structure /products/data/standard/OS/nls contains standard NLS files for the 
Operator Station. This directory structure is only used by ABB Industrial Systems. 


Directory structure /products/data/adaptions/OS/nls may be used by other ABB companies for 
their additions. 


Directory structure /products/data/customer/OS/nls is used by the customer. 


The directories OS/nls/ contains one directory for each loaded language. The available 
languages to load in Advant Station 500 Operator Station version 1.7 and 1.8 are: 


Table 3-1, Available Languages 


Language Symbolic name 


American-English en_US.iso88591 
German de_DE.iso88591 
Swedish sv_SE.iso88591 
Simplified Chinese |zh_CN.hp15CN 
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Create the new directories: 


° Create a new directory $LANG under 
/products/data/adaptions/OS/nls/ 
/products/data/customer/OS/n1s/ 


° Create a new directory $LANG under 
/products/data/adaptions/0OS/lib/ 
/products/data/customer/OS/1lib/ 


° Create a new directory app-defaults under 
/products/data/adaptions/OS/lib/S$LANG/ 
/products/data/customer/OS/lib/S$LANG/ 


Example 


If you want to add finnish to your operator station the directory structure should look like this: 
/products/data/adaptions/0OS/n1s/fi_Fl.iso88591 
/products/data/customer/OS/n1s/fi_Fl.iso88591 
/products/data/adaptions/0OS/1lib/fi_Fl.iso88591 
/products/data/customer/OS/1lib/fi_Fl.iso88591 
/products/data/adaptions/0OS/1ib/fi_Fl.iso88591/app-defaults 
/products/data/customer/0OS/1ib/fi_Fl.iso88591/app-defaults 


3.2.2 Translate all standard texts 


All texts for the local language resides in message files having the file extension .err. To localize 
the operator station they have to be translated to the local language. Some of the texts are 
described in Appendix A. 


° Copy the message files from /products/data/standard/OS/nls/en_US.iso8859 1/ to 
/products/data/adaptions/OS/nls/$LANG/ 


° Translate all texts in the message files under /products/data/adaptions/OS/nls/$LANG/ 


NOTE 


During the translation to a new language it is important that the new texts are not 
longer than the english texts. 


3.2.3 Message Catalogs and Header Files for the translated texts 


For each message file a message catalog and a header file is pointed out. Message catalogs are 
stored in the same place as the message files and the header files are stored under: 
/products/data/standard/OS/include/ 
/products/data/adaptions/OS/include/ 
/products/data/customer/OS/include/. 


Message catalogs are used to separate the text from the application code. In the message 
catalogs the text data is stored in binary format. A message file is used to create this message 
catalog. To create the message catalog and the header file the message file is compiled with the 
command: 

dcNLS file 


Create the new message catalogs and header files: 
— Goto the directory /products/data/adaptions/OS/nls/SLANG/ 


— Give the command deNLS for each message file. 


3BSE 009 666R0001 Rev A 3-3 


AdvaCommandé Localization User’s Guide 
Chapter 3 Configuration/Application Building 


3.2.4 System Variable files 


The language affect several parts in the system. See Table 3-2. 


Table 3-2. Language 


LANGUAGE LANG C_LANGUAGE KEYMAP 
American-English en_US.iso88591 01 abb_modkeys.en_US.iso88591 
Swedish sv_SE.iso88591 46 abb_modkeys.sv_SE.iso88591 
German de_DE.iso88591 49 abb_modkeys.de_DE.iso88591 
Chinese zh_CN.hp15CN 01 abb_modkeys.zh_CN.hp15CN 


3-4 


LANGUAGE: Inform which language the data is valid for. LANGUAGE is visible in the 
Station Settings option menu for System Language. 


LANG: This is the value of the environment variable LANG. The value of LANG for the 
different countries is defined in POSIX. LANG is used at the UNIX-level. 


C_LANGUAGE: The value of the environment variable CLLANGUAGE. C_LANGUAGE is 
given as country number (tel). CLLANGUAGE is used at the RTA-level. 


KEYMAP: Gives the name of the file that the X-client xmodmap uses when the keyboard is 
remapped. 


System variables is used to realize the table. There is one system variable file for each language 
with the name NLSVariables.SLANG. The system variable file for american-english has the 
name NLSVariables.en_US.iso88591 and contains the following lines: 


Uis.SystemVariable.dcLanguageText: “American-English” 
Uis.SystemVariable.dcSysLanguage: “en_US.iso88591” 
Uis.SystemVariable.dcCLanguage: “01” 

Uis.System Variable.dcKbdMap: “abb_modkeys.en_US.iso88591” 


In the option menu for System and Keyboard language the dcLanguageText is presented. 
dcSysLanguage defines $LANG and dcCLanguage define $C_LANGUAGE. These are affected 
by the option menu for the System Language. dcKbdMap defines the current keyboard mapping 
and is set by the option menu for Keyboard Language. 


The system variable files are placed under OS/config/. 
Create the new system variable file: 
° The name on the new system variable file must be NLS Variables. SLANG 


° Put the file under /products/data/adaptions/OS/config/. 
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3.2.5 Keyboard mapping 


When translating from one language to another the keyboard mapping changes as well. 
For example on a Swedish keyboard is | mapped as 6, \ mapped as O, { as 4, [ as A, } as a, and 
finally | as A. To do this remapping of the keyboard the command xmodmap is used. 


The file with the commands to do this contains the following lines: 


keycode 107 = aring Aring degree 

keycode 108 = udiaeresis Udiaeresis brokenbar 

keycode 115 = odiaeresis Odiaeresis lira 

keycode 116 = adiaeresis Adiaeresis quoteleft 

keycode 100 = eacute Eacute plusminus 

The format of the xmodmap-file is: 

keycode NUMBER = KEYSYMBOLI1 KEYSYMBOL2 KEYS YMBOL3 KEYS YMBOL4 


where KEYSYMBOL is the unmodified key, KEYSYMBOL2 is the key with Shift, 
KEYSYMBOL3 is the key with Alt modifier and KEYS YMBOL4 is the key with Shift and Alt 
modifier. 


The KEYS YMBOL that kan be used is found in /usr/include/X11/keysymdef.h (without the 


XK_ prefix). 

The file keysymdef.h contains: 

#define XK_Aring O0x0c5 
#define XK_aring Ox0e5 


use Aring and aring respectively. 


The keyboard symbols must correspond to the selected font decoding. For Swedish the 
encoding is ISO 8859-1, also called Latin-1. ISO 8859-1 is also used for Danish, Dutch, 
English, Faeroese, Finnish, French, German, Icelandic, Irish, Italian, Norwegian, Portuguese, 
and Spanish 


To find out the current keyboard mapping enter: 
xmodmap -pke 


The result can be input to xmodmap command after changes. Normally only the keys you want 
to change should be present in the xmodmap-file. 


The xmodmap-file is placed in the directory: 
/products/data/adaptions/OS/config 
and have the name standard abb_modkeys.<Language>_<Country>.<encoding> 


where <Language> is defined in ISO 639, <Country> in ISO 3166 (Alpha-2 code) and 
<encoding> is one of iso88591 to iso88599 or for Chinese HP15. The last part of the file name 
should be the same as the setting of the environment variable LANG. (Do echo $LANG ina 
terminal window to see its setting) 


For a Swedish keymap the file is named abb_modkeys.sv_SE.iso88591. 


Another useful command is xev_ used to look at the X-events generated from the keyboard. 
To use this program, write xev and place the cursor in the window. For each key now pressed, 
you get a key down and a key up event containing the keycode useful to remap the key. 
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Example of output when the key number 107, swedish 4, is pressed. Information useful for 
keyboard mapping is underlined: 

KeyPress event, serial 19, synthetic NO, window 0x5400001, 

root 0x23, subw 0x0, time 526245903, (176,176), root: (182,201), 
state 0x0, keycode 107 (keysym Oxe5, aring), same_screen YES, 


2 


XLookupString gives 1 characters: “a” 


The complete keyboard mapping for a german operator station is in the file 
abb_modkeys.ge_DE.iso88591 and contains the following: 
keycode 39 = less greater 


keycode 69 = 2 quotedbl at 

keycode 68 = 3 section numbersign 

keycode 65 = 6 ampersand asciicircum 

keycode 64 = 7 slash backslash 

keycode 96 = 8 parenleft bracketleft braceleft 
keycode 97 = 9 parenright bracketright braceright 
keycode 98 = 0 equal questiondown 

keycode 99 = ssharp question 

keycode 100 = apostrophe grave plusminus 

keycode 85 = asciicircum asciicircum 

keycode 107 = udiaeresis Udiaeresis asciitilde asciicircum 
keycode 108 = plus asterisk 

keycode 109 = bracketleft braceleft 

keycode 93 = bracketright braceright 

keycode 115 = odiaeresis Odiaeresis bar backslash 
keycode 116 = adiaeresis Adiaeresis braceleft bracketleft 
keycode 130 = backslash bar 

keycode 37 = Escape Delete 

keycode 121 = comma semicolon less 

keycode 122 = period colon greater 

keycode 123 = minus underscore underscore 


keycode 57 = z Z 
keycode 36 = y Y 


Create the new keyboard map file: 
° Do a Function Restart 


° When the dialog box Workstation mode comes up during start-up. Select Ordinary HP-UX 
workstation. 


° When the HP-UX log in box comes up click on Options and select the new language and 
log in as root. 


° When the HP-UX workstation is up. 
— Open a terminal window and go to /products/data/adaptions/OS/config/. 


— Save the keyboard map file. 
xmodmap -pke > abb_modkeys.SLANG 


- Restart the station. 
su 
shutdown -r -y 0 
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When the station comes up as an Operator Station you have the new keyboard map file under 
/products/data/adaptions/OS/config/. If you want to change anything in the keyboard map file 
the keysymdef-h file and xev command described above can be useful. 


3.2.6 Font handling 


All fonts used in the AS 5000S are standard X fonts. The used fonts can be found in the 
directory /usr/lib/X11/fonts. 


The fonts is found by using a Font Path. The font path can be viewed and set with the xset 
command. 


To view the currently used font path do: 
xset -q 


To add a new font path do: 
xset +fp /newpath/ 


To remove a font path do: 
xset -fp /oldpath/ 


The font path also specifies if a font server should be used. See Section 3.2.6, Font handling for 
more details. 


To get a formatted list of all available fonts in the X-server do the command xlsfonts. 
This command will give a list describing all available fonts in the X-server that look like this. 


: vertical 
foundry weight set width points resolution average width 


-adobe-new century schoolbook-medium-i-normal-- 11-80-100-100-p-60-iso8859-1 


a a | 


font family slant pixels ee spacing character set 


For more information about the individual fields, see Appendix A: Specifying Fonts in the XLib 
Programming Manual (ISBN 1-56592-002-3). 


In the AS 5000S fonts are specified with a short font specification consisting of two letters FA- 
FN and two digits 10-60 in step of 10. These font specifications are connected to real X fonts 
through a definition file. 


The font definition file is placed in the directory: 
/products/data/standard/OS/config/ 


and have the name fontdef.dat. 


default raster 11 -adobe-courier-bold-r-normal-—-—*-—*-—*-—*-*-*-is08859-1 
/* FM 10:12 20:14 30:17 40:18 50:24 60:34 Courier-bold-r */ 
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The first line specifies that font number 11 shall be a courier font. The font specification is the 

standard X font specification described above. The second line is used by process graphics and 
the display builder. FM says that this is font FM, 10:12 specifies that pixelsize 12 shall be used 
for FM10. The last font name string is only shown in the display builder only. 


It is also possible to add a font set used for more than one language by adding a comma 
separated list of fonts. The specification should be on one line, or as in the example below that 
uses a line continuation character as the last character on the line. 


default raster 11 -adobe-courier-bold-r-normal--*-—*-*-*-*-*-is08859-1,\ 
adobe-courier-bold-r-normal-——*-*-—*-—*-*-—*-i1s08859-5 
/* FM 10:12 20:14 30:17 40:18 50:24 60:34 Courier-bold-r */ 


The example above specifies two fonts for the default raster 11 font in Sherrill-Lubinski, one 
used for languages using iso8859-1 encoding and one used for languages using iso8859-5 
enconding. 


NOTE 


When more than one font is specified the iso8859-1 encoding must be specified 
first as in the example above. 


If the encoding is not iso88591 create a new font definition file: 


° Copy fontdef.dat from /products/data/standard/OS/config/ to 
/products/data/adaptions/OS/config/ 


° Add the new font set after the iso88591 font set in fontdef.dat. Separate the font sets with a 
comma. 


3.2.6.1 Font server 


Font server is a program that runs on a host computer somewhere on the network and provides 

fonts to your X server. The font server can understand several different font formats. This means 
that all you have to do, to make a font available, is to run the font server on the hosts where the 
fonts resides. 


To start a font server on an AS 5000S there are two possibilities: 


° During the installation a dialog box appears with the question Configure Font Server? 
Answer Yes to activate the font server. 


° If the Operator Station already is running, log in as root in a terminal window and give the 
command: 
/sbin/set_parms/ font_c-s 


If an Operator Station is running on a X terminal, font access will be less dependent on a single 
X terminal if a font server is running on the host. 
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3.2.7 Resource Files 


Mwm*fontList: 


Fonts are also specified in resource files for Motif. The main resource file is file OS in the 
directory data/standard/OS/lib/en_US.8859 1/app-defaults. This directory also contains resource 
specifications for the tools running in the operator station. 


Fonts are specified as X-resources, like Application.font: FA10. Do not specify a font too 
general, like *Font. This may make applications within the operator station hard or impossible 
to use. 


When translating to a new language a new resource file can be added to the directory: 
/products/data/standard/OS/lib/’ new_language’ /app-defaults/ 


The resource files of interest are OS, Dbuild, DisplayTool, NLSEditor, HPterm and Mwm. 


Dbuild is the resource file for the Display Builder, DisplayTool is the resource file for the 
Display Installer, NLSEditor is the resource file for the System List Translator and OS is the 
common resource file for the Operator Station. In these files all fonts have the short font 
specification from the font definition files. An example from OS: 


os*fontList: FA20 
os*XmPushButton*fontList: FC20 
oS*XmPushButtonGadget*fontList: FC20 
oS*XmLabel*fontList: FA4O 


HPterm is the resource file for the Terminal Window. In this file the font that is defined have the 
standard X font specification. An example from HPterm: 
HPterm*font: *-courier-bold-r-*-14-100-*-iso8859-1 


Mwm is the resource file for Motif Window Manager. In this file all fonts has the standard X 
font specification. An example from Mwm: 


dt-interface system-medium—-r-normal-—m*—*—-*-*-*-*-*-*—* ; 


Mwm*menu*fontList: dt-interface system-medium-r-normal-—m*—*—-*-*-*-*-*-*—* ; 
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NOTE 


In most cases it is not necessary to do anything in the resource files (except 
HPterm). Since it is possible to define several encoding in the font definition file, 
one for each language. The X-server includes the font specification “-dt-interface 
*” for most languages. 


If you want to change font for a certain application: 


° Copy the resource file for that application from 
/products/data/standard/OS/lib/en_US.iso8859 1/app-defaults to 
/products/data/adaptions/OS/lib/$LANG/app-defaults 


° Edit the resource file. 
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3.2.8 Alarm and Event handling 


3.2.8.1 Process Alarm and Event texts 


A process alarm or process event is presented by its name, description, property text and event 
text in a list. The translation to local language of the property and event text are described in this 
section. 


The property and event texts can be either user defined or standard. The user defined property 
and event texts are stored in database elements of type EVENT_TREAT. The standard property 
and event texts are store in the database concept TEXT. Both are located on the Real Time 
Accelerator Board (RTA). 


User defined property and event text 


The user defined property and event texts for standard event handling are stored in EVENTS8 - 
EVENT 14, EVENT 16 - EVENT18. 


The property and event text for the user defined event handling are stored in EVENT20 - 
EVENT300. 


° Enter the System Configuration Dialog. Select <Maintenance...> and thereafter <RTA 
Board Config> 


° Load the command set for database handling: 
—  locpset CMDS:DULO.CT <CR> 


° Dump the source code for the EVENT_TREAT elements to the volume SRCE: which 
corresponds to the directory /products/nodes/PU510/SRCE in the target system. 


- DUDBS SRCE:EVENT,SEL=EVENTS8 - EVENTX <CR> 


where X is the number of the last EVENT element with defined property or event 
text that shall be translated to local language. 


The number of created files depends on how many EVENT_TREAT elements that have 
been dumped. The created files are named EVENTxx.BA. 


° Edit the source code files by using a standard text editor: 


— Enter the System Configuration Dialog. Select <AdvaBuild...> and thereafter 
<Text Editor>. The files are found in directory /products/nodes/PU510/SRCE. 


° Load the modified source code files: 
—  TRDBS SRCE:EVENTxx.BA <CR> 


° Take a backup of the RTA Board by selecting <RTA Board Backup> in the System 
Configuration Dialog. 


° Make a Function Restart. 
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Standard property and event text 


Translation to a native language shall be made in a logical dump of the TEXT concept. You must 
make a logical dump manually as follows: 


° Enter the System Configuration Dialog. Select <Maintenance...> and thereafter <RTA 
Board Config> 


¢ Enter in RTA window 
— DUDB SRCE:<file name> for example DUDB SRCE:STANDARD 
Max length of the file name is 8 characters. Answer the questions as follows: 
— DUMP FROM LF = 31 
— INCLUDE DYNAMIC PROPERTIES? N 
— INCLUDE STRUCTURE OF DYNAMIC PROPERTIES? N 
— INCLUDE ACTION PROPERTIES? N 
— MESSAGE: Dump of standard property and event text 
— DUMP START AT RECORD = 2 
— DUMP STOP AT RECORD = 278 
— ENTER PROPERTY SELECTION DIALOG? N 


The dump is stored in /products/nodes/PUS10/SRCE/. Below is an extract of the dump. 
The dump starts with some headlines which must not be changed. The text to be translated starts 
with line 


1[20005 Value 0 

where 2 is the record number, 0 0 0 are pointers which shall not be changed. 5 is the number of 
characters in the property or event text. Thereafter follows the text to be translated. The text and 
the number of characters can be changed using a standard text editor. 


* JLA 201 
SRCE:STANDARD.LD 
Midas Data Base Logical Dump 
Copyright ASEA 
58 Selective dump of logfile 31 created 1998-09-10 13:06:20 
14 standard texts 
5 \*+-/ 
0 31 0 FFFFFFFF 5 
0 2 0 20 0 FFFFFFFF 1 
0 3 0 20 0 FFFFFFFF 1 
05 0 20 0 TFFFFFFF 1 
0 6 0 40 0 FFFFFFFF 1 
0 7 0 40 0 FFFFFFFF 1 
][20005 Value 0 
1[3 0007 Sig.Err 0 
1140006 Lim H20 
1[50006Lim H1 0 
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60006LimL1 0 
70006LimL20 
80005 Value 0 

90008 Printout 0 


[ 

[ 

[ 

[ 

[100005 Alarm 0 

[ 110006 Update 0 

[ 120008 Disturb. 0 
[ 13 0007 Opening 0 
[ 140007 Closing 0 
[ 15 0008 NotClose 0 
[ 160008 Not Open 0 


ee ee ee eee 


The dump contains all records from 2 to 280. However some of the texts are not longer used and 
no translation is necessary. The records to be translated are: 


recordno 2-132 
150 - 221 
232 - 233 
238 - 239 
261 - 278 


Enter the Terminal Window 
° Edit the file by using a standard text editor for example: 


— Enter the System Configuration Dialog. Select <AdvaBuild...> and thereafter 
<Text Editor>. The file is found in directory /products/nodes/PU510/SRCE. 


The new dump must be loaded into the target system manually: 
e LODB SRCE:<file name> for example LODB SRCE:STANDARD 
Answer the questions as follows: 
— TARGET NOT IN CONFIGURATION MODE. PROCEED? Y 
— LOAD MODE: I 
— RECEIVER LF = 31 
— ENTER RECORD SELECT NODE? N 
— LOAD START AT RECORD = 2 


° Take a backup of the RTA Board by selecting <RTA Board Backup> in the System 
Configuration Dialog. 


° Make a Function Restart. 
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3.2.8.2 System Alarm texts 


An event in the System List has the following layout: 


* POW SUPP ST 24V I/O supply A faulty Net 22 Nod 56 96-04-01 14:29:41:425 


System Part 
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System Part Description Net & Node Date & Time 


The text row contains: 

¢ System Part text which is a description of in which subsystem the error occurred. 
¢ System Part Description which gives the operator more detail about the event. 

¢ Net and node which guides the operator to the correct System Status display. 

¢ Date and time of the event. 


Translation to a native language must be made by using the database source code facilities for 
dumping and loading the TEXT concept against the UNIX environment. The language in the 
dump depends on the system language in Station Settings. It may be English, German or Swedish 
as standard. If another language is included in the OS this can of course be used as original lan- 
guage if the system messages have been translated to this language. 


A help to translate system messages, the System List Translator, is included in the OS. 
To use this tool you must first make a logical dump as described below: 


° Enter the System Configuration Dialog. Select <Maintenance...> and thereafter <RTA 
Board Config> 


¢ Enter in RTA window 
— EXECFILE INIT:DUSYS 


A dump is generated and is stored in directory /products/nodes/PUS10/SRCE/. It is called 
TEXT.LD. 


You activate the System List Translator as follows: 
° Select Stations and open a Terminal Window.Enter in the window: 
—  SysListTranslator 


A list showing all the system messages in the original language is displayed. The list is an extract 
of the original logical dump. You can not make any selections in this list. It is only used as an 
overview of all the system messages. 
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If a translated file exist an overview of these system messages is also displayed. 


System List - Overview 


1220 AF100 STATUS Fatal bus error Net@1A3@ Nod @2A3@ 
1221 AF100 STATUS Cable @213@ broken Net @1A3@ Nod @2A3@ 


Tees 


essage parameter parameters 
number 


Figure 3-1. Extract from the list containing all system messages 


A display also shown in which you make the translation, see Figure 3-2: 


System List Translator 
File Help 


Apply 
280 Next 


Message number: 


PROC I/O ST 


@3A2@-board error 


Net@1A3@ Nod@2A3@ 


Figure 3-2. Dialog box for entering system message text 


At start-up the first message (no 280) is displayed. The three text fields to the left contain the orig- 
inal text. In the three empty text fields to the right you enter the text for the native language. 
The three text fields display the following text: 


¢ System Part Text 
¢ System Part Description 
¢ Net and Node number. 


There may be parameters in the text. The parameter is replaced in runtime by its actual value for 
example net number. A parameter starts and ends with the sign “@”. The parameters must be 
written in the same way as in the original version (for example @1A3@). 


As the net and node text is the same for all system messages you only have to type it once. 
It remains in the third text field. 
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There is a limitation of characters in the text fields. The limit is 12 characters for 8 bit characters 
for the System Status Text and 28 characters for 8 bit characters for the System Part Description 
text. Corresponding values for 16 bit characters (for example chinese) are 6 characters for the 
System Status Text and 14 characters for the System Part Description text. 


You can navigate between text fields in a predefined pattern. After entering text in a text field you 
move the cursor to the next text field by pressing the tab function key on the keyboard. 


You must save the entered text for each message. You do this by pressing the Apply Next button 
which also does a step forward in the system message list. that is the next system message is dis- 
played. The text fields to the right are left empty for your input, except the Net and Node text field 
which you only have to fill in once. 


You can also type a message number in the number field and press <CR> to get the text belonging 
to the message. 


The Menu Bar is located in the upper part of the display and consists of pull-down menus for all 
the features and activities you need to translate the system texts: 


File 

New 

A new empty file is created. The text fields to the right are empty and ready for input. 
Open... 


A list of all the translated files as well as the original TEXT is displayed. This is only useful if 

you work with more than one translation. You select which file you want to work with. The text 
fields to the right contain the translated text. The text fields to the left still contain the text from 
the original dump. The translated text can be modified. 


Save 


The translated text is saved and the tool calculates new text pointers. The text pointers are used 
to position the text correctly in the system list.The text and the pointers are put in an outfile which 
shall be loaded into the system. 


Save As... 


Same as Save but you must give a name to the translated file. The maximum length of the name 
is 8 characters for example French, DUTCH or SPANISH. 


Exit 


Terminates the System List Translator. If you have unsaved changes a box is displayed asking 
you to Save before Exit. 


Help 


Helps you to use the tool. 


The new dump which is created after Save or Save As... is located in the same directory as the 
original dump that is /products/nodes/PU510/SRCE. The new dump must be loaded into the tar- 
get system either using a script or manually. 
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Alternative 1: 


Using the script you must use a predefined name on the translated file. 


Enter the System Configuration Dialog. Select Stations and open a Terminal Window. 


Enter 
— cd /products/nodes/PU510/SRCE (You go to a directory) 
- dU (All files in the directory are listed.) 
—- cp XXXX.LD NEW.LD (This means that you copy the file you have 
translated and named XXXX to a file called 
NEW.LD.) 
NOTE 


You must use capitals for the name and add the suffix .LD. 


Enter the System Configuration Dialog. Select <Maintenance...> and thereafter <RTA 
Board Config> 


Enter in RTA window 
— EXECFILE INIT:LOSYS 


Alternative 2: 


Making the load manually you do not have to rename your translated file. 


Enter the System Configuration Dialog. Select <Maintenance...> and thereafter <RTA 
Board Config> 


Enter in RTA window 
— LODB SRCE:XXX where XXX is the name of the dump. 


NOTE 


Max number of characters for the name is 8 and the characters must be capitals. 


Answer the questions as follows: 

— NOTIN CONFIGURATION MODE PROCEED? Y 
— LOAD MODE? I 

— RECEIVER LF= 31 

— ENTER RECORD SELECT LOAD =N 

— LOAD START AT RECORD = 280 

— ENTER PROPERTY CHANGE DIALOG? N 


Take a backup of the RTA Board by selecting <RTA Board Backup> in the System 
Configuration Dialog. 


Make a Function Restart. 


Note that the name of the dump in the directory /products/nodes/PU510/SRCE gets a suffix 
“LD”. This suffix shall not be given in Save As... or when dumping or loading. 
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3.2.9 Printer handling 


In Advant Station 500 Series Operator Station three main types of printouts are used, line printer 
printouts, postscript printouts and hardcopy printouts. This sections describes, for each printout 
type, which changes that are needed when using a new language. For additional information 
about printers in Advant Station 500 Series Operator Station, see the User’s Guide 
AdvaCommand Basic Functions, chapter Printer Configuration. 


3.2.9.1 Line printer 


Line printer printouts are used for Alarm and Event printouts, Status List, AMPL generated 
reports and printouts of text files in standard Advant Station 500 Series Operator Station. 


AMPL generated reports uses the printer queues Printer! and Printer2 and supports characters 
used in American-English, German and Swedish. 


Alarm, Event and Status List printouts uses the printer queues Line and List. In the printer 
scripts Line and List, that are used by the printer queues Line and List, a reference to a program 
that converts characters from ISO8859-1 to ASCII is included. Note! The printer scripts and the 
printer queues uses the same name. This is not a must. The name of a printer script and a printer 
queue may differ. 


The program that handles the conversion from ISO 8859-1 into ASCII uses the file 
“/products/components/Tools/config/dcPrintLineConvert.dat”. This file defines which 
characters to be converted. The character conversion file dcPrintLineConvert.dat is copied, 
when system language is set, from a language specific version of this file. Three language 
specific versions are available as default, namely American-English, German and Swedish. 
The language specific version are identified with the file suffix $LANG, for example 
dcPrintLineConvert.sv_SE.iso88591 for the swedish version. The contents of 
dcPrintLineConvert.sv_SE.iso88591 is shown below: 


19691 (for example 196=A in ISO 8859-1 and 91=[ which normally are substituted to A) 
197 93 

214 92 

228 123 

246 124 

229 125 


The left column shows the ISO 8859-1 character code for the characters to be converted. 
The right column shows the corresponding ASCII character code. 


When a new language, supported by ISO8859-1, is used do as follows: 


° Copy an existing character conversion file, for example 
dcPrintLineConvert.sv_SE.iso88591, to the new language version. 


° Edit the new file. Insert one column with the characters, in ISO 8859-1 format, to be 
converted and one column with the corresponding characters in ASCII. 


° Change into the new language with the configuration tool “Station Settings” and restart the 
system. 
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3.2.9.2 PostScript 
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To support printouts of alarm, events and Status List printouts based on a language that doesn’t 
use ASCII characters, for example Chinese, two simple printer scripts “Line.Template” and 
“List.Template” are added to the operator station. These printer scripts are located at the 
directory “/usr/spool/lp/model/”’. 


° Take copies of the printer scripts Line.Template and List. Template. 


° Edit the new printer scripts and add control codes requested by your local printer. Control 
codes are added below the line “# Enter control codes for your specific printer below”, se 
example below. 


° Use the Printer Configuration tool to configure printer queues that uses the new printer 
scripts. 


Postscript printouts are used by the functions “Display Printout”, “On-line Builder” and “RTA 
Board Config.”. 


Display Printout 
Display Printout uses the printer queue ‘Postscript’ for its printouts. This printer queue supports 
languages that may be represented using ISO 8859-1 encoding. 


In all printer scripts, used in the operator station, that supports postscript a reference to a 
postscript definition file for ISO 8859-1 Encoding are added. This file is located at 
“/products/data/standard/OS/config/iso8859-1 Encoding”. 


In ISO 8859-1Encoding postscript fonts that corresponds to the fonts defined in fontdef.dat are 
defined. Fonthandling and fontdef.dat are described in Section 3.2.6, Font handling. 


When fontdef.dat is changed, supporting another character set, the corresponding changes must 
be made within this postscript definition file iso8859-1Encoding. 


° Take a copy of the postscript definition file iso8859-1Encoding, for example iso8859- 
5Encoding and place it in the directory “/products/data/customer/OS/config/” or 
“/products/data/adaption/OS/config/”’. 


° Make the necessary changes within this new postscript definition file. 


° Take a copy of the postscript printer script that you intend to use for printouts with 
“Display Printout’. As default the printer script “postscript” is used. Printer scripts are 
located at “/usr/spool/lp/model/”’. 


° Edit the copied printer script and change the reference to the postscript definition file that 
you changed. Tip: search for iso8859-1Encoding in the printer script. 


° Use the Printer Configuration tool to configure a printer queue that uses the new printer 
script. 


On-line Builder / RTA Board Config 

Postscript printouts are handled the same way for both On-line Builder and RTA Board Config. 
Both functions uses the printer queue OnlineB for its printouts. The printer queue OnlineB is 
default configured for printouts using a postscript printer. On-line Builder supports the 
languages American-English, German and Swedish. 


On-line Builder and RTA Board Config supports input of text using characters available in 
American-English, German and Swedish. A consequence of this is that printouts from On-line 
Builder and RTA Board Config may only include characters from these languages. 
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3.2.10 RTA- Board 
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No changes are needed for hardcopy printouts.This printout type uses bitmapped screen dumps 
and is independent of different languages. 


Backup 


The language dependent dumps on the RTA board are called DATHO1.$LANG where $LANG 
is the language variable for example en_US.iso88591 for the English-American version. 


The dumps are stored in the directory /products/nodes/PUS510/cxINIT. The dump contain texts 
for for example Event and Alarm Handling, Status List and TTD properties. 


When introducing a new language you must copy one of the dumps in the directory 
/products/nodes/PU510/cxINIT and name the copy in a predefined way for example 
zh_CN.hp15CN for the Chinese version 


When translating the text for example event text and system messages text you edit the copied 
file. 


3.2.11 Station Backup 


3BSE 009 666RO0001 RevA 


To save the additions for localization use Station Backup. You have two alternatives: 


1. Take a backup of the Operator Station Disk Data. Select Backup of OS Configurable Data. 
To add the additions for localization select the files with Interactive Restore. 


2. Add a new program/script for backup of the localization files. The program/script can be 
added to your Operator Station. If you place the program/script in the directory 
/products/components/Backup/tools/ it will automatically be included among the other 
choices when the Station Backup is started. 
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3.3 How to add and modify texts 
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There is one subsystem defined for customer , named b;CUSTOMER, and one for adaptions, 
named bsADAPTION and one for standard, named bsOS. Each subsystem has a component 
definition file. These files has the following name and location: 
/products/data/customer/OS/nls/bsCUSTOMER.def 
/products/data/adaptions/OS/nls/bsADAPTION.def 
/products/data/standard/OS/nls/bsOS.def 


NOTE 


The file bsOS.def is also located under customer and adaptions so the system can 
find modified standard NLS texts under customer and/or adaptions 


The syntax for the component definition file is: 


‘subSystem’ 

‘component’_’subSystem’ number ‘file name for the message catalog ’ 
‘component’_’subSystem’ number ‘file name for the message catalog ’ 
‘component’_’subSystem’ number ‘file name for the message catalog ’ 
and so on.... 

Example: 

bsCUSTOMER 

processA_bsCUSTOMER 1 processA.cat 
processB_bsCUSTOMER 2 processB.cat 
specials_bsCUSTOMER 3 Specials.cat 


A maximum of 99 (1-99) components may be defined. Our recommendation is to divide the 
components in such a way that as few message catalogs as possible are used at the same time 
when a process display is presented. for example divide the components according to the 
different process sections. For each component a header file is needed that contain mnemonic 
names for each numerical value. The header file is stored in OS/include/. To create the header 
file the component file is compiled with the command bsGenerate. 


The command syntax for bsGenerate is: 
bsGenerat d fil 


The syntax for the message files are: 


‘component’_’subsystem’ 


‘textname’_“component’_’subsystem’ number ‘text’ 
‘textname’_“component”_’subsystem’ number ‘text’ 
‘textname’_“component’_’subsystem’ number ‘text’ 

and so on.... 

Example: 

processA_bsCUSTOMER 

StatorCurrent_processA_bsCUSTOMER 1 Stator Current 
StatorVoltage_processA_bsCUSTOMER 2 Stator Voltage 
StatorCurrent_processB_bsCUSTOMER 101 Stator Current 
StatorVoltage_processB_bsCUSTOMER 102 Stator Voltage 
SpecialTexts_specials_bsCUSTOMER 201 Special Text 
and so on. 
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The numbering do not have to be in a sequence but must be in numerical order. It is allowed to 
group the texts in number groups. In the example above Texts for Process A starts with number 
1 and Process B with number 101. Considering future expansions, it is recommended to divide 
the numbering in message catalogs in groups. A maximum of 999 (1-999) texts may be defined 
in a message file. 


To create the message catalog and the header file that is needed for each message file. 
The message file is compiled with the command: 
dcNLS file 


Message files are normally created for the local language and for en_US.iso88591 (American- 
English) language. All software uses the text stored in directory en_US.iso88591 if not found 
elsewhere. 


Some examples 


° To change a standard NLS text. For example Input Blocked to Inp BI for an AT: 
(bsOS is still used because it is a standard NLS text) 


— Create a file dcAi-err under adaptions or customer: 
dcAi_bsOS 
InputBlocked_dcAi_bsOS 3 Inp BI 


— Generate a message catalog and a header file for dcAi.err 
dcNLS dcA err. 


° To create new texts. For example texts to an own display element MOTVAL: 
(bsADAPTION is used because the text is added under adaptions and it is not a standard 
NLS text) 


— Create a file dC MOTVAL.err under adaptions: 
dcMOTVAL_bsADAPTIONS 
messagel_dcMOTVAL_bsADAPTION 1 Messagel 
message2_dcMOTVAL_bsADAPTION 2 Message2 


— Generate a message catalog and a header file for dC MOTVAL.err 
dcNLS dcMOTVAL.err 


— Add the message catalog to bsADAPTION.def 
bsADAPTION 
dcMOTVAL_bsADAPTION 1 dcMOTVAL.cat 


- Generate a header file for bsADAPTION.def 
bsGenerate -d bsADAPTIONS.def. 


3.3.1 Display Builder 


The Display Builder is a menu-driven, interactive utility program that you use to plan and 
design custom graphic displays in the Advant Station 500 Series Operator Station. This section 
gives a description of the additions done for the NLS handling in the Display Builder. 

For additional information about the Display Builder, read the User’s Guide AdvaBuild Display 
Builder. 
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3.3.1.1 Display Description 
Choose Display Attributes from the Tools menu. 
The Display Attributes box is displayed. 


= | Display Attributes 

Library 

Display 

Description 

Hi NLSText {Select or Create a NLS-Text| | Help 


Background N13 


Base Display BaseDisplay — 


Default Screen 


Overlap Display | Not possible — 


Position X 10 Y |0 
Size x [500 Y | 303 
Page Left 
Page Right 
Page Help 
Dynamic Function Keys 
Define ... Copy ... 
OK Apply Cancel Help 


Figure 3-3. Display Attributes Box 
The description text can be defined either as an ordinary string or as an NLS reference. 
This NLS reference is defined as a symbolic constant in a Text file - dcUser1.err 
If you choose an ordinary string, enter the description in the Description field, for example: 
Overview Feeder. 
If you choose an NLS reference, enter the symbolic constant in the Description field like: 


OverviewFeeder_dcUser1_bsCUSTOMER 


NOTE 


The button in front of ‘NLSText’ must be pressed. Otherwise it will be handled as 
an ordinary text string. 
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If you don’t know what NLS references you have, it is possible to search for an NLS reference 
or create a new. Click on the Select or Create a NLS-Text button, after a few seconds a Text 
Editor Window appears. 


=| Text Editor - dcUser1.err ° 
File Edit Search Format Help 


dcUser1_bsCUSTOMER /\\ 
# Syntax to be used: 

# <message>_dcUser1_bsCUSTOMER <index> <text> 
# 61 = dcUser1, 16 = bsCUSTOMER 

# example: 
# 


61 16 

# Message_dcUser1_bsCUSTOMER 1 Message 

fh een eee een eee eee ence ee een ee een eee en ee een ee een eee en ee een ee eeeneeeee ne neen ee eeeneeeenneneenneseenenesnenes 
OverviewFeeder_dcUser1_bsCUSTOMER 1 Overview Feeder 


ry, 
a 


Figure 3-4. Text Editor - dcUserIl.err 


Search for an NLS reference. When you find your NLS reference, enter the symbolic constant in 
the Description field like: 


Overview Feeder_dcUser1_bsCUSTOMER 


If you do not find any suitable NLS reference, then you can create a new, for example, an NLS 
reference for Pulp Produce. 


=] Text Editor - dcUser1.err o | 
File Edit Search Format Help 
dcUser1_bsCUSTOMER /\\ 
# Syntax to be used: 

# <message>_dcUser1_bsCUSTOMER <index> <text> 

# 61 = dcUser1, 16 = bsCUSTOMER 

# example: 

# 1 61 16 

# Message_dcUser1_bsCUSTOMER 1 Message 

Phen ween ee ee ete ee ee ee ee ee eee ee ee eee ee eee eee eee eee eee 
OverviewFeeder_dcUser1_bsCUSTOMER 1 Overview Feeder 
PulpProduce_dcUser1_bsCUSTOMER 2 Pulp Produce 
EE 38 


Figure 3-5. Text Editor - dcUserl.err 
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After you add the new NLS reference and save the file dcUserl1.err, enter the new symbolic 


constant in the Description field. 


PulpProduce_dcUser1_bsCUSTOMER 


After editing the new symbolic constant in the NLS-Text field, click OK or Apply. When 
clicking OK or Apply, a background program - bsGenerate - generates a catalog file and a 


header file. 


If a display is installed with an already defined symbol constant, it’s very easy to correct a 
misspelling while working with the Display Builder. 


Click on Select or Create a NLS-Text button. 


Correct the misspelling and save the file dcUser1.err. 


Click OK or Apply. 


When you bring up the display again the text should be correct. 


3.3.1.2 Dynamic Keys 


Click on Define ... to define dynamic function keys connected to the display. 


A new dialog box is displayed. 


= | Dynamic Key Definition 


Display 


DO1 
DO2 
DO3 
D04 
DO5 
DO6 
DO7 
DOs 
DO9 
D10 


Key Label 


W NLSText /Select or Create a NLS-Text| |Help 


Text Font 


Font Color 


Key Type 


Display Name 


Base Display = 


Free 


OK 


Apply 


Cancel 


Help 


Figure 3-6. Dynamic Key Definition Box 
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Click on one of the keys, for example, DO1, in the list. 


The key label text can be defined either as an ordinary string or as an NLS reference. 
These NLS reference are defined as a symbolic constant in a Text file - dcUser1.err 


If you choose an ordinary string, enter the key label in the Key Label field, for example, 
Report Display. 
If you choose an NLS reference, enter the symbolic constant in the Key Label field like. 


ReportDisplay_dcUser1_bsCUSTOMER 


NOTE 


The button in front of ‘NLSText’ must be pressed. Otherwise it will be handled as 
an ordinary text string. 


If you don’t know what NLS references you have, it is possible to search for an NLS reference 
or create a new. Click on Select or Create a NLS-Text button, after a few second a Text Editor 
Window appears. 


| Text Editor - dcUser1.err o | 
File Edit Search Format Help 
dcUser1_bsCUSTOMER VV 
# Syntax to be used: 
# <message>_dcUser1_bsCUSTOMER <index> <text> 
# 61 = dcUser1, 16 = bsCUSTOMER 
# example: 
# 1 61 16 
# Message_dcUser1_bsCUSTOMER 1 Message 
Price tine haart aetna elation esa ie dna mies gem etiam nines eee 
OverviewFeeder_dcUser1_bsCUSTOMER 1 Overview Feeder 
PulpProduce_dcUser1_bsCUSTOMER 2 Pulp Produce 
ReportDisplay_dcUser1_bsCUSTOMER 3 Report Display 

Vi 


es 


Figure 3-7. Text Editor - dcUserl.err 


Search for an NLS reference. When you find your NLS reference, enter the symbolic constant in 
the Description field like. 


ReportDisplay_dcUser1_bsCUSTOMER 


3-25 


AdvaCommandé Localization User’s Guide 
Chapter 3 Configuration/Application Building 


If you do not find any suitable NLS reference, then you can create a new, for example, an NLS 
reference for Pump Overview. 


=| Text Editor - dcUser1.err o | 
File Edit Search Format Help 
dcUser1_bsCUSTOMER /\\ 
# Syntax to be used: 

# <message>_dcUser1_bsCUSTOMER <index> <text> 

# 61 = dcUser1, 16 = bsCUSTOMER 

# example: 

# 61 16 

# Message_dcUser1_bsCUSTOMER 1 Message 

Pins teeanacdenvecnessacosanasccasasawasneeceastecacseckassnemasccessstamsdecmancasascectaascascsandencecomeaseusd 
OverviewFeeder_dcUser1_bsCUSTOMER 1 Overview Feeder 
PulpProduce_dcUser1_bsCUSTOMER 2 Pulp Produce 
ReportDisplay_dcUser1_bsCUSTOMER 3 Report Display 
PumpOverview_dcUser1_bsCUSTOMER 4 Pump Overview 


iy, 
a 


Figure 3-8. Text Editor - dcUser1.err 
When you have added the new NLS reference and saved the file dcUser1.err, enter the new 
symbolic constant in the Key Label field. 
PumpOverview_dcUser1_bsCUSTOMER 


After entering the new symbolic constant in the NLS-Text field, click OK or Apply. 
When clicking OK or Apply, a background program - bsGenerate - generate a catalog file and a 
header file. 


If a display is installed with an already defined symbol constant, it’s very easy to correct a 
misspelling while working with the Display Builder. 


Click on Select or Create a NLS-Text button. 
Correct the misspelling and save the file dcUser1.err. 
Click OK or Apply. 


When you bring up the display again the text should be correct. 


3.3.1.3 Display Element 


To display the Attributes box for a text display element, do one of the following actions: 
° double-click on the display element, 


° select the display element and choose Display Element Attributes from the Tools menu. 
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= NLSPD0O1ref0 
Position X| 53.9312 Y | 28.8 
Size X| 6.09375 Y | 1.71875 
Parameter 
NLS-Text 
H NLSText Select or Create a NLS-Text Help 
TextColor M16 
TextFont FA40 
Alignment 1 
1= Left | 2 = Center | 3= Right 
OK Apply Cancel Help 


The NLS-Text can be defined either as an ordinary string or as an NLS reference. 
This NLS reference is defined as symbolic constant in a Text file - dcUser1.err 


If you choose an ordinary string, enter the text in the NLS-Text field, for example, 


Pump No 1 


If you choose an NLS reference, enter the symbolic constant in the NLS-Text field like. 


Figure 3-9. Display Element Attributes Box 


PumpNol1_dcUser1_bsCUSTOMER 


The button in front of ‘NLSText’ must be pressed. Otherwise it will be handled as 


NOTE 


an ordinary text string. 
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If you don’t know what NLS references you have, it is possible to search for an NLS reference 
or create a new. Click on Select or Create a NLS-Text button, after a few second a Text Editor 
Window appears. 


=| Text Editor - dcUser1.err : | 
File Edit Search Format Help 
dcUser1_bsCUSTOMER V\ 
# Syntax to be used: 

# <message>_dcUser1_bsCUSTOMER <index> <text> 

# 61 = dcUser1, 16 = bsCUSTOMER 

# example: 

# 1 61 16 

# Message_dcUser1_bsCUSTOMER 1 Message 

fh nea name dentnmennieannadcnasacanasa sna scananeedendansnemacnneaeasndamacmesasendimieneasmcndimaansesesceaaesan 
OverviewFeeder_dcUser1_bsCUSTOMER 1 Overview Feeder 
PulpProduce_dcUser1_bsCUSTOMER 2 Pulp Produce 
ReportDisplay_dcUser1_bsCUSTOMER 3 Report Display 
PumpOverview_dcUser1_bsCUSTOMER 4 Pump Overview 
PumpNo1_dcUser1_bsCUSTOMER 5 Pump No 1 


g 
es = 


Figure 3-10. Text Editor - dcUserl.err 


Search for an NLS reference. When you find your NLS reference, enter the symbolic constant in 
the NLS-Text field like. 


PumpNo1_dcUser1_bsCUSTOMER 


If you do not find any suitable NLS reference, then you can create a new, for example, an NLS 
reference for Feeder Speed. 


=] Text Editor - dcUser1.err : | 
File Edit Search Format Help 
dcUser1_bsCUSTOMER /\ 
# Syntax to be used: 

# <message>_dcUser1_bsCUSTOMER <index> <text> 

# 61 = dcUser1, 16 = bsCUSTOMER 

# example: 

# 61 16 

# Message_dcUser1_bsCUSTOMER 1 Message 

Ph cae menace cane caccnamastend cenaaaaae same daasannatemanae same saaceantaeaas ee snantasbenandatmmeasaaecdaacoaanscmen 
OverviewFeeder_dcUser1_bsCUSTOMER 1 Overview Feeder 
PulpProduce_dcUser1_bsCUSTOMER 2 Pulp Produce 
ReportDisplay_dcUser1_bsCUSTOMER 3 Report Display 
PumpOverview_dcUser1_bsCUSTOMER 4 Pump Overview 
PumpNo1_dcUser1_bsCUSTOMER 5 Pump No 1 
FeederSpeed_dcUser1_bsCUSTOMER 6 Feeder Speed 


es 


Figure 3-11. Text Editor - dcUserl.err 
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When you have added the new NLS reference and saved the file dcUser1.err, enter the new 
symbolic constant in the Description field. 


FeederSpeed_dcUser1_bsCUSTOMER 


After editing the new symbolic constant in the NLS-Text field, click OK or Apply. 
When clicking OK or Apply, a background program - bsGenerate - generate a catalog file and a 
header file. 


If a display is installed with an already defined symbol constant, it’s very easy to correct a 
misspelling while working with the Display Builder. 


Click on Select or Create a NLS-Text button. 
Correct the misspelling and save the file dcUser1.err. 
Click OK or Apply. 


When you bring up the display again the text should be correct. 


3.3.2 Process Object Description 


Each process object description or other process object text in the database is recognized by its 
symbolic name, for example PulpProduce_dcUser1_bsCUSTOMER, its text “Pulp Produce” 
or its NLS-index, 16,61,2. Where b;CUSTOMER = 16, dcUser! = 61 and PulpProduce = 2. 


The NLS-index is entered in the process object database and used as a cross-reference link 
between process object description and the language specific text. The NLS-index is seven (7) 
characters long and entered into the description field of the database for each process object. 
The following format is used: 


SSCCNNMFree 


SS = Subsystem number. Uses 2 characters, legal values are 00-99. 
bsADAPTION = 15 and bs;CUSTOMER = 16. 


CC = Component number. Uses 2 characters, legal values are 00-99. 
NNN = Text number. Uses 3 characters, legal values are 000-999. 


Free = The remaining text space for Description is 13 characters. These may be used in any way 
you like, for example English descriptive text. 


Example of a process object description using NLS index: 


“1661002PulpProduce”’, 
where 
16 =subsystem bsCUSTOMER 
61 =component dcUser1 
002 = message Pulp Produce and 
PulpProduce is free English text used in the remaining 13 characters of the 
process object description. 


When a message file is created, edited and defined in the component definition file, it must be 
compiled into a message catalog. As described earlier, the command used is bsGenerate. 
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3.3.3 Display element and Process Dialogs 
A Display Element for user defined NLS text 


3.3.3.1 Standard Display Element NLSPD0O1 


Presentation: 
1. Text 


Alignment = 1 NLS Text 


Alignment = 2 NLS gext 


Definition Point 


Alignment = 3 NLS Text 


Behavior: 
No Description Presentation Condition Remarks 
1 Text NLS-Text The text via ordinary string or 
NLS reference 
Grey - TextColor, TextFont 
Configuration: 
Parameters Affects Options (bold is default) Remarks 
TextColor 1. Text M16 (Grey), any color 
TextFont 1. Text FA40, any font 
Alignment 1. Text 1 = Left, 2 = Center, 3 = Right 
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3.3.3.2 Changes in Display Elements 
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This section is only for those who has built or are going to build own designed display 
elements. 


If there is hard coded text in the *.g-file it must be moved to the *.de-file. All hard coded text in 
the *.de-file must be converted to NLS references with a symbolic constant, ex. 


Feeder_dcUser1_bsCUSTOMER 


Every NLS reference with a symbolic constant off type Section_dcPid_bsOS or 
Class_dcAi_bsOS should be converted through a NLSText component, so that the text look-up 
is made at runtime. Below is shown one old and one new version on a part of a display element. 
Old version: 


var = DynamicVariables 


{ 
SectionNLS String = InTerminal 


{ 
datatype = “String 10” 
value = { Section_dcPid_bsOS } 


} 


New version: 


components = List 


{ 
TranslatedNLSText = NLSText 


{ 
datatype = “String 10” 
inl = { Section_dcPid_bsOS } 
outl = “Section” 


} 


var = DynamicVariables 


{ 
SectionNLSString = InTerminal 


{ 
datatype = “String10” 
value = ::TranslatedNLSText::Section 


} 


By using the method, described in Section 3.3.2, Process Object Description, process object 
descriptions may be presented on the operator screen in the local language. NLSText is added in 
the Display Element for translation of the NLS-index, as shown below. 


TranslatedAttribute = NLSText 
{ 


datatype = “String28” 
inl = ::components::AI::DESCRIPTION 
out! = “DESCRIPTION” 
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Even other text in the object database can be presented in local languages. 
For example for Motcon the text for the properties PRES_A, PRES_B, 

IND2_10_PRES_TEXT,IND2_11_PRES_TEXT, IND2_12_PRES_TEXT, 
IND2_13_PRES_TEXT, IND2_14_ PRES_TEXT and ACT_PRES_TEXT. 


Below is shown one old and one new version on a part of display element MOTGRO1. 
Old version: 


var = Dynamic Variables 


{ 


Description = InTerminal 


{ 

datatype = “String28” 

value = ::components::MOTCON::DESCRIPTION 
} 


ActPresTxtString = InTerminal 


{ 
datatype = “String20” 
value == ::components:: MOTCON::ACT_PRES_TEXT 


} 


New version: 


components = List 


{ 
TranslatedAttribute = NLSText 


{ 
datatype = “String28” 


inl = ::components::MOTCON::DESCRIPTION 

in2 = ::components::MOTCON::ACT_PRES_TEXT 
out! = “DESCRIPTION” 

out2 = “ACT_PRES_TEXT” 


} 


var = DynamicVariables 


{ 
Description = InTerminal 
{ 
datatype = “String28” 
value =::TranslatedAttribute:: DESCRIPTION 
} 
ActPresTxtString = InTerminal 
{ 
datatype = “String20” 
value =::TranslatedAttribute::ACT_PRES_ TEXT 
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Object Display 


The datatype for Display Description is changed from String to NativeString, so that the text 
look-up is made at runtime. Below is shown the old and the new part for Description from the 
file dcAiObjectDisplay.ds. 


Old version: 


Description = Property 
{ 
runtimeAccess = “READ” 
value = { ObjectDisplay_dcMMITEXT_bsOS } 


datatype = “String” 
factoryAccessible = true 
} 
New version: 
Description = Property 


{ 


runtimeAccess = “READ” 

value = { ObjectDisplay_dcMMITEXT_bsOS } 
datatype = “NativeString” 

factory Accessible = true 


3.3.3.3 Changes in Process Dialogs 


This section is only for those who has built or are going to build own designed process 
dialogs. 


The texts on the dynamic keys are moved from the <file.pcd> to the <file.d>. So we will not 
have any text dependencies in the <file.pcd>. 


Example: In dcAoDialogKeys.pcd all labelstring are removed: 
labelString = “\ENAcknowledge_dcAo_bsOS”; 


In the <file.d> a new devent called ‘dynKeyText’ is added. This devent contain all the texts (for 
example labelString) for the dynamic keys. This devent will be sent when a new Key Group is 
managed. 


Example: When the Key Group with the dynamic keys keyboard is brought up in dcAoDialog.d 


keyboardKeys does 
-- tu_printf( “... keyboardKeys starts \n” ); 


activeWidget.managed := false; 
activeWidget := topAo->keybKeys; 
this .sendDEvent (dynKeyText, 0) ; 


activeWidget.managed := true; 


-- tu_printf(“--- keyboardKeys ends \n"”); 
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end 


dynKeyText does 
-- tu_printf(“... dynKeyText starts \n"”); 
i : integer; 
keyName : string; 
tmpWidget : widget; 
if (activeWidget = keybKeysKeyGroup) and (maxDialog = true) 
then 
if NLS_keybKeysKeyGroup.count = 0 then 


NLS_keybKeysKeyGroup.insert ( 
uiGetBsMessage (Increase_dcAo_bsOS),1); 
NLS_keybKeysKeyGroup.insert ( 
uiGetBsMessage (ManDK_dcAo_bsOS) ,2); 
NLS_keybKeysKeyGroup.insert ( 
uiGetBsMessage (AutoDK_dcAo_bsOS) ,3); 
NLS_keybKeysKeyGroup.insert (““, 4); 
NLS_keybKeysKeyGroup.insert (““,5); 
NLS_keybKeysKeyGroup. insert 

uiGetBsMessage (Decrease_dcAo_bsOS),6); 
NLS_keybKeysKeyGroup.insert ( 

uiGetBsMessage (Acknowledge_dcAo_bsOS) ,7)j; 
NLS_keybKeysKeyGroup.insert ( 

uiGetBsMessage (ObjectDisplay_dcAo_bsOS) , 8); 
NLS_keybKeysKeyGroup.insert ( 

uiGetBsMessage (ObjectTrend_dcAo_bsOS) , 9); 


NLS_keybKeysKeyGroup.insert (““,10); 

end if; 

ee eller 

while (i < 11) do 
keyName := “db” + (string) i; 
tmpWidget := activeWidget-—>(keyName) ; 
tmpWidget.labelString := NLS_keybKeysKeyGroup [i]; 
1 21 + 1; 


end while; 


-- tu_printf(“--- dynKeyText ends \n"”); 
end 


3.4 Configuration/Application Building Menus 


Refer to the manuals for the software. See Section 1.5, Related Documentation. 
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Chapter 4 Runtime Operation 


4.1 Operating Overview 


The translation is normally made on the parts that concern the operator. The translated texts will 
be presented to the operator when running the system. Some texts are not translated and not all 
the configuration tools are translated. For configuration of the system, normally you need some 
knowledge in english. Some texts residing in the AC 400 database are not possible to translate. 


4.2 Runtime Operation Menus 


The texts in the system are fetched and presented in runtime. It is preferred to present the NLS 
text at runtime as: 


— Texts (for example message catalogs) can be updated and the result is taken into 
operation without the need to reconvert displays, display elements or process dialogs. 


—  Itis no need to keep object files for several languages in parallel. 
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Chapter 5 Maintenance 


5.1 Backup/Restore Procedures 


For backup and restore procedures, refer to the Release Notes for more information. 
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Appendix A Text Files 


A.1 dcBasic 


The text in the text file dcBasic.err comes mostly from the Basic Functions in the Advant 
Operator Station. Here follows a description of the texts from the Basic Functions: 


Table 1-1. Texts from Basic Functions 


Cs 


The display is not allowed to be presented as an overlapping 
display - isOverlapDisplay = NIL 


11 
12 
13 


15 
16 
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Table 1-1. Texts from Basic Functions (Continued) 


Basic Text Comments 
The Menu key is not valid The MENU key doesn’t’ exist. 
27 +| The NEXT DIALOG BLOCK key is not valid The NEXT DIALOG BLOCK key, the display doesn’t define it 


Config. error: A display link may not have object name set to | Display Element with Action = dialog and with object name set to 
“NIL”. NIL 


a 
Object display: No object identity is found. 
a7 


= 


Name select is active. Object name is %T. Another object name is checked if it can be resolved 
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Table 1-1. Texts from Basic Functions (Continued) 


se 
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A.2 dcDialogMsg 


The text in the text file dcDialogMsg.err comes from the Dialog for each Process Object. 
Below is a description when the text will appears, some text are self-evident when they appears. 


Table 1-2. Description when the texts will appear 


1 %T is selected by another user Object is already selected by another user 

2 %T is not allowed to be selected Object is not allowed to be selected 

3 Invalid select status on %T Invalid select status on selected Object 

4 %T could not be selected Object could not be selected 

5 Selection time-out on %T Selection timeout on selected Object - Not used yet. 

6 Dialog time-out on %T Selection timeout on Object if the dialog is inactive more than 2 
minutes 

7 Prevented authority to operate on %T Prevented authority to operate on selected Object 

8 Warning! Outside authorized area to operate on %T Warning! Outside authorized area to operate on selected Object 

9 Entered data is not valid. Must be a number Entered value in CommandLine is of incorrect format 

Output or Setpoint is not active Output or Setpoint is not active for selected Object, GENCON, 

10 
GENUSD, PIDCON and PIDCONA 

11 Output or Ratio is not active Output or Ratio is not active for selected Object, RATIOSTN 

12 There are no more dialog blocks on this level There are no more dialog blocks on this level - Appears when 
operator hit the “Next Block” key. 

13 This is the top dialog level This is the top dialog level - Appears when operator hit the 
“Previous Level” key. 

14 Order not allowed in MIN Dialog Order not allowed in MIN Dialog 

15 Entered year value is not valid Entered year value is not valid for DAT 

16 Entered month value is not valid Entered month value is not valid for DAT 

17 Entered day value is not valid Entered day value is not valid for DAT 

18 Entered hour value is not valid Entered hour value is not valid for DAT 

19 Entered minute value is not valid Entered minute value is not valid for DAT 

20 Entered second value is not valid Entered second value is not valid for DAT 

21 %T could not be selected, object not active Object could not be selected, object not in active group 

22 %T could not be selected, object not bound Object could not be selected, object not bound to server 

The object could not be selected, the object has no dialog The object could not be selected, the object has no dialog. 

23 It’s only a dialog skeleton defined for object type GU2, GU3, 
GU4, GU5, GU6, MMCX36, MMCX37 and MMCX38. 

24 Entered data is not valid. Must be an integer Entered data is not valid. Must be an integer for object type GU1. 

25 ‘| Value out of range for INTW. Input ignored. Entered value greater than 32767 or less than -32768 
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A.3 dcMMITEXT 


The text in the text file dc MMITEXT.err comes mostly from the MasterPiece or the 
AdvantController. It is texts from the Object Handler, TTD and SystemStatus. Below is a 
description when the text will appears, some text are self-evident when they appears. 


The text no. 51 -140 and 1051 - 1080 is used by the Object handler. 
The text no. 150 - 174 and 250 - 299 is used by the TTD. 


The text no. 300 -310 is used by the System Status. 


Here follow a description of the texts from the Object Handler: 


Table 1-3. Description from Object Handler 


51 Illegal operation code. Illegal operation code in order request. 

52 Illegal operation property. Illegal operation property in oder request 

53 Object not selected (or not implemented). Object not implemented or not selected 

54 Operation is not allowed when process update is not Process updating not blocked 

blocked. 

55 Limit out of range. Input ignored. Limits out of range 

56 ‘| Value out of range. Input ignored. Value out of range 

57 Limit not used. Input ignored. Requested limit not used, for Al 

58 Manual orders blocked. Command ignored. Manual orders are blocked 

59 Blocking of Integration not allowed. Command ignored. Block of integration only allowed as PC-input for PIDCON 

60 Blocking of Derivation not allowed. Command ignored. Block of derivation only allowed as PC-input for PIDCON 

61 Manual mode selection not allowed. Manual mode not allowed 

62 _ | Auto mode selection not allowed. Auto mode not allowed 

63 E1 mode selection not allowed. E1 mode not allowed 

64 E2 mode selection not allowed. E2 mode not allowed 

65 E3 mode selection not allowed. E3 mode not allowed 

66 = _| Setpoint is tracking. Input ignored. Setpoint is tracking for PIDCONA and PIDCON 

67 Output value can only be changed in manual mode. Outsignal can only be changed in manual mode 
for PIDCONA, PIDCON and RATIOSTN 

68 Output value is connected to external reference. Outsignal is connected to external reference 
for PIDCONA, PIDCON and MANSTN 

69 Three point control not implemented. DZ not used. Deadzone is not implemented for PIDCON 
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Table 1-3. Description from Object Handler (Continued) 


74 Object not selected. Command ignored. Object not selected 

78 Command not allowed in this mode. Command ignored. Wrong mode for this operation to be performed 

79 Object already blocked. Object is already blocked 

80 Object not blocked. Object is already deblocked 

81 Object already in Manual mode. Object in manual mode 

82 Object already in Auto mode. Object in auto mode 

83 | Board already in service. Already in service 

84 Board already out of service. Already out of service 

85 No instances connected to board. No objects connected to interface board for AO and DO-interface 

86 Ratio connected to external reference. Ratio is connected to external reference for RATIOSTN 

97 Object already in hold mode. Already in hold mode for SEQUENCE 

98 ‘| Object not implemented. Object is not implemented 

99 _ ‘| Step conditions not fulfilled. Conditions for stepping are not fulfilled 

101 | Instance does not exist or board not implemented. Record is not found OR interface is not implemented or not found 

102 | Board out of service. Interface is out of service for Al, AO, DI and DO 

103 | Hardware error reported. Hardware error for DI 

104 | Output temporary locked. Try again. The record is locked while physical output is done for AO and DO 

105 | Output failed. Output failed for AO and DO 

106 | Attempt to read input failed. Converter type is out of range for Al 

107 Illegal data type. Illegal datatype in format, i.e. external reference, tag or format 
reference for DAT 

108 | Concept/property not found in logical file 1. Concept/Property name not found in LF 1 for DAT 

109 | The sequence is not running. Command ignored. Sequence is not running for SEQUENCE 

110 | Event print already blocked. Event print already blocked for SEQUENCE 

111. | Event print already deblocked. Event print not blocked for SEQUENCE 

112 | Event proc. already blocked. Event processing is already blocked for SEQUENCE 
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113 


Table 1-3. Description from Object Handler (Continued) 


Event proc. already deblocked. 


Event processing not blocked for SEQUENCE 


114 


Limit is not active for this object. 


MAX_LIM or MIN_LIM is not used for AO 


115 


The input is not calculated. Command ignored. 


Attempt to change calc_value for a non-calc. input for Al or DI 


116 


Attempt to change Max limit to be less than Min limit. 


New MAX_LIM value is less than actual MIN_LIM value, order is 
not performed 


117 


Attempt to change Min limit to be greater than Max limit. 


New MIN_LIM value is greater than actual MAX_LIM value, order 
is not performed 


118 


Flag in MORD_ALLOWED is not true. Command is not 
performed. 


Order is not performed as corresponding flag in 
MORD_ALLOWED is not set for GENOBJ 


Flag in VALUE_ALLOWED is not true. Command is not 


Value change order is not performed as corresponding flag in 


119 performed. VALUE_ALLOWED is not set for GENOBJ 
120 Object is selected by another operator. Command is not Order is not performed as actual object is selected by another 
performed. operator (network,node,mmi) for DAT 
121 | Value out of range. Value out of range 
422 Attempt to change OUT max to be < OUT min. New OP_MAX value is less than actual OP_MIN value or out of 
range of (0,100), order is not performed for GERNOBJ 
123 Attempt to change OUT min to be > OUT max. New OP_MIN value is greater than actual OP_MAX value or out 
of range of (0,100), order is not performed for GERNOBJ 
124 Attempt to change SP max < SP min or out of range of MV New SP_MAX value is less than actual SP_MIN value or out of 
limits. range of (MV_MIN,MV_MAX), order is not performed, GERNOBJ 
125 Attempt to change SP min > SP max or out of range of MV New SP_MIN value is greater than actual SP_MAX value or out 
limits. of range of (MV_MIN,MV_MAX), order is not performed 
126 Command is not performed. Command blocked by Value change order is not performed as corresponding flag in 
ORD_BLK in the database. ORDER_BLOCK is not set for GROUP_ALARM 
127 Change of Group Type is not allowed when members are Value change order is not performed as system not is in 
connected to the group. configuration mode or memb_count isn’t 0 for GROUP_ALARM 
128 Flag in ORD_BLK is true. Command not performed. Value change order is not performed as corresponding flag in 
ORD_BLK is set for TEXT_DATA 
129 Attempt to change dispmax > dispmin. Command is not Attempt to change DISPMAX > DISPMIN, order is not performed 
performed. for TEXT_DATA 
130 Max no. of connections exceeded. Command is not The groupmember is already connected to seven groups, order is 
performed. not performed for GROUP_ALARM 
131 Object not in redundancy use or not in service. Command is | Object not in redundancy use 
not performed. 
132 | Interface has fatal error status. Command is not performed. | OBJ_INTERFACE has fatal error 
133 | Board 2 has error status. Command is not performed. OBJ_INTERFACE: Board 2 has error status 
134 | Board 1 has error status. Command is not performed. OBJ_INTERFACE: Board 1 has error status 
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Table I-3. Description from Object Handler (Continued) 


Member already connected to this group. Command is not 


Member already connected to this group, order is not performed 


135 performed. for GROUP_ALARM 
136 | Property already set. Command is not performed. Value already set for Al 
137 | Property already reset. Command is not performed. Value already reset for Al 
138 | Not supported function for this object type. Not supported function for this object type 
1051 | Frequency limit must be greater than zero. Frequency limit must be greater then zero 
1052 The level must be greater than zero and less than or equal to] The level must be greater then zero and less than or equal to 
50%. 50% 
1053 | Mode BAL prevents start of autotuning. Mode BAL prevents the start of autotuning 
1054 | Mode MAN CLAMPED prevents start of autotuning. Mode MAN CLAMPED start of prevents autotuning 
1055 | Mode MAN FORCED prevents start of autotuning. Mode MAN FORCED start of prevents autotuning 
1056 | Al ERROR prevents start of autotuning. Al ERROR start of prevents autotuning 
1057 | Autotuning is not in verify phase, prevents CONTINUE TUNE | Autotuning is not in VERIFY phase, prevents CONTINUE TUNE 
1058 RESTORE before you CONTINUE TUNE, or use START RESTORE before you CONTINUE TUNE, or use START TUNE 
TUNE. 
1059 Issue START TUNE, there is nothing to CONTINUE TUNE Issue START TUNE, there is noting to CONTUNE TUNE from 
from. 
1060 Time-out counter has been restarted, due to CONTINUE Time-out counter has been restarted, due to CONTINUE TUNE 
TUNE. 
1061 You cannot do ACCEPT & SAVE until the EXCITE or VERIFY | You cannot do ACCEPT & SAVE until the EXCITE or VERFY 
phase. phase 
1062 | Since not autotuning ACCEPT & SAVE gave only SAVE. Since not autotuning ACCEPT & SAVE gave only SAVE. 
1063 | Autotuning stopped. Present setting unchanged. Autotuning stopped. Present setting unchanged. Noting saved. 
1064 Since not autotuning STOP & RESTORE gave only Since not autotuning STOP & RESTORE gave only RESTORE 
RESTORE. 
1065 Wait until autotuning is finished before ADAPTATION Wait until autotuning is finished before ADAPTATION ENABLE 
ENABLE. 
1066 | Issue START TUNE before ADAPTATION ENABLE. Issue START TUNE before ADAPTATION ENABLE 
1067 | Autotuning prevents SAVE, use ACCEPT & SAVE instead. Autotuning prevents SAVE, use ACCEPT & SAVE instead 
1068 Autotuning prevents RESTORE, use STOP & RESTORE if Autotuning prevents RESTORE, use STOP & RESTORE if 
desired. desired 
1069 Present setting unchanged. There was no setting to Present setting unchanged. There is no setting to RESTORE 
RESTORE. 
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Table 1-3. Description from Object Handler (Continued) 


Value can only be changed when adaptation and autotuning 


Value can only be changed when adaptation and autotuning is off 


1070 are off 

1071 STOP & RESTORE active autotuning, before you START STOP & RESTORE active autotuning, before you START TUNE 
TUNE. 

1072 Warning: There are parameter sets with invalid sampling Warning: there are setting with invalid sampling rate. 
rate (TS). 

1073 | Autotuning is disabled at PC element. Autotuning is disabled at PC element. 

1074 | Value can only be greater than or equal to zero. Value can only be greater than or equal to zero. 

1075 | Change of response type is not allowed during verify phase. | Change of response type is not allowed during verify phase. 

1076 VERIFY is only valid during the excitation phase of VERIFY is only valid during the excitation phase of autotuning. 
autotuning. 

1077 | There is no aborted setting to retrieve. There is no aborted setting to retrieve. 

1078 You cannot SAVE a setting while waiting for the lost one to | You cannot SAVE a setting while waiting for the lost one to be 
be retrieved. retrieved. 

1079 While retrieving the lost setting RESTORE commands are While retrieving the lost setting RESTORE commands are 
ignored. ignored. 

1080 | Wait until aborted setting has been retrieved. Wait until aborted setting has been retrieved. 


Here follows a description of the texts from the TTD Handler: 


Table 1-4. Description from TDD Handler 


250 | TTD: The request is correctly performed. TTD request ok 

251 +=~+| TTD: Function not implemented. Illegal operation code in ttd request 

252 | TTD: Log not found. Log not found 

253 | TTD: Log not implemented. Log not implemented 

254 | TTD: Variable not found. Variable not found 

255 | TTD: Variable not implemented. Variable not implemented 

256 | TTD: Number of requested variables out of range. Number of requested variables out of range 
257 | TTD: Number of requested values out of range. Number of requested values out of range 
258 | TTD: Time completely out of TTD’s scope Time completely out of TTD’s scope 

268 | TTD: Illegal logical file number Illegal reference of logical file number 
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Table 1-4. Description from TDD Handler (Continued) 


269 | TTD: Illegal subscription code (sub type) Illegal subtype request 

270 | TTD: Illegal data type (ttd type) Illegal value type 

271 +=~+| TTD: Illegal value in time specification Illegal value of time 

272 | TTD: the log is no user data log Log not user type 

273 + =+‘| TTD: Illegal reference type (ref type) Illegal reference type 

274 | TTD: Illegal property number Illegal property number 

275 | TTD: Additional information (add inf) missing No additional info defined 

277 + | TTD: referenced concept not defined in the node Referenced concept not defined in system 
278 | TTD: referenced instance not found in the node Referenced file not found 

279 | TTD: referenced object or log is not implemented Referenced file not implemented 
280 | TTD: referenced variable is not found in the log Referenced variable not found 

281 | TTD: referenced variable is not implemented Referenced variable not implemented 
282 | TTD: referenced variable is not initiated Referenced variable not initiated 
283 | TTD: access to primary logged object failed Access to primary variable failed 
285 | TTD: access to primary logged object failed Failed to get physical address 

286 | TTD: the log is a backup log Log is a backup log 

287 | TTD: program error Program error in TTD 

288 | TTD: illegal log reference Illegal log number 

289 | TTD: the sample intervals do not match Illegal sample interval 

290 | TTD: referenced log is a user data log Referenced log is user log 

291 | TTD: referenced log is a backup log Referenced log is backup log 

292 | TTD: illegal code for requesting information (geti mode) Illegal geti_mode 

293 | TTD: log or log interval must be specified Neither log_ref nor log_interval was given 
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